10.3 查询现金渠道订单(代收、代付)
#简要描述: 该接口用于查询现金渠道代收付订单,根据订单号能够查看其订单详情。
- 请求方式: POST
- 请求接口: https://网关域名/wallet-trade-merchant/v1/receive/cash/query/by-third
- 请求媒体类型( JSON 数据格式 )Content-Type: application/json
查询参数
| 参数名称 | 类型 | 必填 | 参数含义 | 参数说明 |
|---|---|---|---|---|
| orderId | string | 否 | 平台订单号 | 我 方平台订单号或商户本地订单号2选1 |
| localOrderId | string | 否 | 商户本地订单号 | 商户本地订单号或我方平台订单号2选1 |
| key | string | 是 | 商户key | apiKey |
| sign | string | 是 | 签名 | 详情见签名算法 |
请求json样例
{
"key": "9yUreYgTRtit39Dy",
"orderId": 274224939517780,
"sign": "07792d2cf97811d3f2e7bd98edb477e3"
}
返回值
| 参数名称 | 类型 | 参数含义 | 参数说明 |
|---|---|---|---|
| code | int32 | 请求状态 | 返回代码,0为业务成功,否则代表不同的错误 |
| success | boolean | 成功状态 | 成功标识,与code=0一致,用于兼容历史 |
| message | string | 描述 | 错误消息。如果有错误时,返回的错误消息 |
| data | json | 返回数据 | 参数详见下面说明 |
返回示 例
{
"code": 0,
"success": true,
"message": null,
"data": {
"merchantId": 302992856974,
"merchantUserId": "conan",
"orderId": "477564506808517",
"localOrderId": "conantest9913279",
"type": "PAYMENT",
"status": "SUCCESS",
"currency": "CNY",
"paidAmount": "100",
"amount": "100",
"isReissue": false,
"notifyTime": 1772789295567,
"orderCreateTime": 1772789258844
}
}
data参数说明
| 参数名称 | 类型 | 参数含义 | 参数说明 |
|---|---|---|---|
| merchantId | int64 | 商户ID | |
| merchantUserId | string | 商户用户ID | 对应下单参数 localUserId 的值 |
| orderId | string | 订单号 | 我方平台订单号 |
| localOrderId | string | 商户本地订单号 | 商户本地平台订单号(对应下单参数 localOrderId 的值) |
| type | enum | 订单类型 | PAYMENT:支付订单 | WITHDRAW:提款订单 |
| status | enum | 订单状态 | PROCESSING:处理中| SUCCESS:已完成|FAIL:已失败 |
| currency | string | 订单币种 | |
| paidAmount | number | 订单应收、付金额 | |
| amount | number | 订单金额 | |
| isReissue | boolean | 是否补发 | |
| notifyTime | int64 | 通知时间戳 | 毫秒 |
| orderCreateTime | int64 | 订单创建时间戳 | 毫秒 |